<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>gimpitem: GIMP 3 Library Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GIMP 3 Library Reference Manual">
<link rel="up" href="libgimp-image.html" title="Manipulating Images and their Properties">
<link rel="prev" href="libgimp3-gimpmetadata.html" title="gimpmetadata">
<link rel="next" href="libgimp3-gimpitemtransform.html" title="gimpitemtransform">
<meta name="generator" content="GTK-Doc V1.33.0 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#GimpItem.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#GimpItem.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="libgimp-image.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="libgimp3-gimpmetadata.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="libgimp3-gimpitemtransform.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GimpItem"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GimpItem.top_of_page"></a>gimpitem</span></h2>
<p>gimpitem — Functions to manipulate items.</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GimpItem.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a class="link" href="GimpItem.html" title="gimpitem"><span class="returnvalue">GimpItem</span></a> *
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-by-id" title="gimp_item_get_by_id ()">gimp_item_get_by_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint32</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-id" title="gimp_item_get_id ()">gimp_item_get_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-is-valid" title="gimp_item_is_valid ()">gimp_item_is_valid</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-id-is-valid" title="gimp_item_id_is_valid ()">gimp_item_id_is_valid</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GimpImage.html" title="gimpimage"><span class="returnvalue">GimpImage</span></a> *
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-image" title="gimp_item_get_image ()">gimp_item_get_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-delete" title="gimp_item_delete ()">gimp_item_delete</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-is-drawable" title="gimp_item_is_drawable ()">gimp_item_is_drawable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-id-is-drawable" title="gimp_item_id_is_drawable ()">gimp_item_id_is_drawable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-is-layer" title="gimp_item_is_layer ()">gimp_item_is_layer</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-id-is-layer" title="gimp_item_id_is_layer ()">gimp_item_id_is_layer</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-is-text-layer" title="gimp_item_is_text_layer ()">gimp_item_is_text_layer</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-id-is-text-layer" title="gimp_item_id_is_text_layer ()">gimp_item_id_is_text_layer</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-is-channel" title="gimp_item_is_channel ()">gimp_item_is_channel</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-id-is-channel" title="gimp_item_id_is_channel ()">gimp_item_id_is_channel</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-is-layer-mask" title="gimp_item_is_layer_mask ()">gimp_item_is_layer_mask</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-id-is-layer-mask" title="gimp_item_id_is_layer_mask ()">gimp_item_id_is_layer_mask</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-is-selection" title="gimp_item_is_selection ()">gimp_item_is_selection</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-id-is-selection" title="gimp_item_id_is_selection ()">gimp_item_id_is_selection</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-is-vectors" title="gimp_item_is_vectors ()">gimp_item_is_vectors</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-id-is-vectors" title="gimp_item_id_is_vectors ()">gimp_item_id_is_vectors</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-is-group" title="gimp_item_is_group ()">gimp_item_is_group</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GimpItem.html" title="gimpitem"><span class="returnvalue">GimpItem</span></a> *
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-parent" title="gimp_item_get_parent ()">gimp_item_get_parent</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GimpItem.html" title="gimpitem"><span class="returnvalue">GimpItem</span></a> **
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-children" title="gimp_item_get_children ()">gimp_item_get_children</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GList</span> *
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-list-children" title="gimp_item_list_children ()">gimp_item_list_children</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-expanded" title="gimp_item_get_expanded ()">gimp_item_get_expanded</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-set-expanded" title="gimp_item_set_expanded ()">gimp_item_set_expanded</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-name" title="gimp_item_get_name ()">gimp_item_get_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-set-name" title="gimp_item_set_name ()">gimp_item_set_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-visible" title="gimp_item_get_visible ()">gimp_item_get_visible</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-set-visible" title="gimp_item_set_visible ()">gimp_item_set_visible</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-linked" title="gimp_item_get_linked ()">gimp_item_get_linked</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-set-linked" title="gimp_item_set_linked ()">gimp_item_set_linked</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-lock-content" title="gimp_item_get_lock_content ()">gimp_item_get_lock_content</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-set-lock-content" title="gimp_item_set_lock_content ()">gimp_item_set_lock_content</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-lock-position" title="gimp_item_get_lock_position ()">gimp_item_get_lock_position</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-set-lock-position" title="gimp_item_set_lock_position ()">gimp_item_set_lock_position</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../html/libgimpbase3-gimpbaseenums.html#GimpColorTag"><span class="returnvalue">GimpColorTag</span></a>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-color-tag" title="gimp_item_get_color_tag ()">gimp_item_get_color_tag</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-set-color-tag" title="gimp_item_set_color_tag ()">gimp_item_set_color_tag</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guint</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-tattoo" title="gimp_item_get_tattoo ()">gimp_item_get_tattoo</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-set-tattoo" title="gimp_item_set_tattoo ()">gimp_item_set_tattoo</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-attach-parasite" title="gimp_item_attach_parasite ()">gimp_item_attach_parasite</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-detach-parasite" title="gimp_item_detach_parasite ()">gimp_item_detach_parasite</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/local/head/share/gtk-doc/html/libgimpbase/libgimpbase-GimpParasite.html#GimpParasite"><span class="returnvalue">GimpParasite</span></a> *
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-parasite" title="gimp_item_get_parasite ()">gimp_item_get_parasite</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> **
</td>
<td class="function_name">
<a class="link" href="GimpItem.html#gimp-item-get-parasite-list" title="gimp_item_get_parasite_list ()">gimp_item_get_parasite_list</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GimpItem.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    GObject
    <span class="lineart">╰──</span> GimpItem
        <span class="lineart">├──</span> <a class="link" href="GimpDrawable.html" title="gimpdrawable">GimpDrawable</a>
        <span class="lineart">╰──</span> <a class="link" href="GimpVectors.html" title="gimpvectors">GimpVectors</a>
</pre>
</div>
<div class="refsect1">
<a name="GimpItem.description"></a><h2>Description</h2>
<p>Functions to manipulate items.</p>
</div>
<div class="refsect1">
<a name="GimpItem.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gimp-item-get-by-id"></a><h3>gimp_item_get_by_id ()</h3>
<pre class="programlisting"><a class="link" href="GimpItem.html" title="gimpitem"><span class="returnvalue">GimpItem</span></a> *
gimp_item_get_by_id (<em class="parameter"><code><span class="type">gint32</span> item_id</code></em>);</pre>
<p>Returns a <a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> representing <em class="parameter"><code>item_id</code></em>
. Since <a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> is an
abstract class, the real object type will actually be the proper
subclass.</p>
<div class="refsect3">
<a name="gimp-item-get-by-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item_id</p></td>
<td class="parameter_description"><p>The item id.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-by-id.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> for <em class="parameter"><code>item_id</code></em>
or
<code class="literal">NULL</code> if <em class="parameter"><code>item_id</code></em>
does not represent a valid item.
The object belongs to libgimp and you must not modify
or unref it. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-id"></a><h3>gimp_item_get_id ()</h3>
<pre class="programlisting"><span class="returnvalue">gint32</span>
gimp_item_get_id (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<div class="refsect3">
<a name="gimp-item-get-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-id.returns"></a><h4>Returns</h4>
<p> the item ID.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-is-valid"></a><h3>gimp_item_is_valid ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_is_valid (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns TRUE if the item is valid.</p>
<p>This procedure checks if the given item is valid and refers to an
existing item.</p>
<div class="refsect3">
<a name="gimp-item-is-valid.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item to check.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-is-valid.returns"></a><h4>Returns</h4>
<p> Whether the item is valid.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-id-is-valid"></a><h3>gimp_item_id_is_valid ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_id_is_valid (<em class="parameter"><code><span class="type">gint</span> item_id</code></em>);</pre>
<p>Returns TRUE if the item ID is valid.</p>
<p>This procedure checks if the given item ID is valid and refers to an
existing item.</p>
<div class="refsect3">
<a name="gimp-item-id-is-valid.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item_id</p></td>
<td class="parameter_description"><p>The item ID to check.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-id-is-valid.returns"></a><h4>Returns</h4>
<p> Whether the item ID is valid.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-image"></a><h3>gimp_item_get_image ()</h3>
<pre class="programlisting"><a class="link" href="GimpImage.html" title="gimpimage"><span class="returnvalue">GimpImage</span></a> *
gimp_item_get_image (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns the item's image.</p>
<p>This procedure returns the item's image.</p>
<div class="refsect3">
<a name="gimp-item-get-image.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-image.returns"></a><h4>Returns</h4>
<p>The item's image. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-delete"></a><h3>gimp_item_delete ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_delete (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Delete a item.</p>
<p>This procedure deletes the specified item. This must not be done if
the image containing this item was already deleted or if the item
was already removed from the image. The only case in which this
procedure is useful is if you want to get rid of a item which has
not yet been added to an image.</p>
<div class="refsect3">
<a name="gimp-item-delete.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item to delete.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-delete.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-is-drawable"></a><h3>gimp_item_is_drawable ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_is_drawable (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns whether the item is a drawable.</p>
<p>This procedure returns TRUE if the specified item is a drawable.</p>
<div class="refsect3">
<a name="gimp-item-is-drawable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-is-drawable.returns"></a><h4>Returns</h4>
<p> TRUE if the item is a drawable, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-id-is-drawable"></a><h3>gimp_item_id_is_drawable ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_id_is_drawable (<em class="parameter"><code><span class="type">gint</span> item_id</code></em>);</pre>
<p>Returns whether the item ID is a drawable.</p>
<p>This procedure returns TRUE if the specified item ID is a drawable.</p>
<div class="refsect3">
<a name="gimp-item-id-is-drawable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item_id</p></td>
<td class="parameter_description"><p>The item ID.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-id-is-drawable.returns"></a><h4>Returns</h4>
<p> TRUE if the item ID is a drawable, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-is-layer"></a><h3>gimp_item_is_layer ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_is_layer (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns whether the item is a layer.</p>
<p>This procedure returns TRUE if the specified item is a layer.</p>
<div class="refsect3">
<a name="gimp-item-is-layer.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-is-layer.returns"></a><h4>Returns</h4>
<p> TRUE if the item is a layer, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-id-is-layer"></a><h3>gimp_item_id_is_layer ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_id_is_layer (<em class="parameter"><code><span class="type">gint</span> item_id</code></em>);</pre>
<p>Returns whether the item ID is a layer.</p>
<p>This procedure returns TRUE if the specified item ID is a layer.</p>
<div class="refsect3">
<a name="gimp-item-id-is-layer.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item_id</p></td>
<td class="parameter_description"><p>The item ID.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-id-is-layer.returns"></a><h4>Returns</h4>
<p> TRUE if the item is a layer, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-is-text-layer"></a><h3>gimp_item_is_text_layer ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_is_text_layer (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns whether the item is a text layer.</p>
<p>This procedure returns TRUE if the specified item is a text
layer.</p>
<div class="refsect3">
<a name="gimp-item-is-text-layer.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-is-text-layer.returns"></a><h4>Returns</h4>
<p> TRUE if the item is a text layer, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-id-is-text-layer"></a><h3>gimp_item_id_is_text_layer ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_id_is_text_layer (<em class="parameter"><code><span class="type">gint</span> item_id</code></em>);</pre>
<p>Returns whether the item ID is a text layer.</p>
<p>This procedure returns TRUE if the specified item ID is a text
layer.</p>
<div class="refsect3">
<a name="gimp-item-id-is-text-layer.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item_id</p></td>
<td class="parameter_description"><p>The item ID.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-id-is-text-layer.returns"></a><h4>Returns</h4>
<p> TRUE if the item is a text layer, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-is-channel"></a><h3>gimp_item_is_channel ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_is_channel (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns whether the item is a channel.</p>
<p>This procedure returns TRUE if the specified item is a channel.</p>
<div class="refsect3">
<a name="gimp-item-is-channel.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-is-channel.returns"></a><h4>Returns</h4>
<p> TRUE if the item is a channel, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-id-is-channel"></a><h3>gimp_item_id_is_channel ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_id_is_channel (<em class="parameter"><code><span class="type">gint</span> item_id</code></em>);</pre>
<p>Returns whether the item ID is a channel.</p>
<p>This procedure returns TRUE if the specified item ID is a channel.</p>
<div class="refsect3">
<a name="gimp-item-id-is-channel.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item_id</p></td>
<td class="parameter_description"><p>The item ID.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-id-is-channel.returns"></a><h4>Returns</h4>
<p> TRUE if the item ID is a channel, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-is-layer-mask"></a><h3>gimp_item_is_layer_mask ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_is_layer_mask (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns whether the item is a layer mask.</p>
<p>This procedure returns TRUE if the specified item is a layer
mask.</p>
<div class="refsect3">
<a name="gimp-item-is-layer-mask.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-is-layer-mask.returns"></a><h4>Returns</h4>
<p> TRUE if the item is a layer mask, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-id-is-layer-mask"></a><h3>gimp_item_id_is_layer_mask ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_id_is_layer_mask (<em class="parameter"><code><span class="type">gint</span> item_id</code></em>);</pre>
<p>Returns whether the item ID is a layer mask.</p>
<p>This procedure returns TRUE if the specified item ID is a layer
mask.</p>
<div class="refsect3">
<a name="gimp-item-id-is-layer-mask.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item_id</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-id-is-layer-mask.returns"></a><h4>Returns</h4>
<p> TRUE if the item ID is a layer mask, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-is-selection"></a><h3>gimp_item_is_selection ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_is_selection (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns whether the item is a selection.</p>
<p>This procedure returns TRUE if the specified item is a selection.</p>
<div class="refsect3">
<a name="gimp-item-is-selection.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-is-selection.returns"></a><h4>Returns</h4>
<p> TRUE if the item is a selection, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-id-is-selection"></a><h3>gimp_item_id_is_selection ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_id_is_selection (<em class="parameter"><code><span class="type">gint</span> item_id</code></em>);</pre>
<p>Returns whether the item ID is a selection.</p>
<p>This procedure returns TRUE if the specified item ID is a selection.</p>
<div class="refsect3">
<a name="gimp-item-id-is-selection.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item_id</p></td>
<td class="parameter_description"><p>The item ID.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-id-is-selection.returns"></a><h4>Returns</h4>
<p> TRUE if the item ID is a selection, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-is-vectors"></a><h3>gimp_item_is_vectors ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_is_vectors (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns whether the item is a vectors.</p>
<p>This procedure returns TRUE if the specified item is a vectors.</p>
<div class="refsect3">
<a name="gimp-item-is-vectors.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-is-vectors.returns"></a><h4>Returns</h4>
<p> TRUE if the item is a vectors, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-id-is-vectors"></a><h3>gimp_item_id_is_vectors ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_id_is_vectors (<em class="parameter"><code><span class="type">gint</span> item_id</code></em>);</pre>
<p>Returns whether the item ID is a vectors.</p>
<p>This procedure returns TRUE if the specified item ID is a vectors.</p>
<div class="refsect3">
<a name="gimp-item-id-is-vectors.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item_id</p></td>
<td class="parameter_description"><p>The item ID.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-id-is-vectors.returns"></a><h4>Returns</h4>
<p> TRUE if the item ID is a vectors, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-is-group"></a><h3>gimp_item_is_group ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_is_group (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns whether the item is a group item.</p>
<p>This procedure returns TRUE if the specified item is a group item
which can have children.</p>
<div class="refsect3">
<a name="gimp-item-is-group.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-is-group.returns"></a><h4>Returns</h4>
<p> TRUE if the item is a group, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-parent"></a><h3>gimp_item_get_parent ()</h3>
<pre class="programlisting"><a class="link" href="GimpItem.html" title="gimpitem"><span class="returnvalue">GimpItem</span></a> *
gimp_item_get_parent (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns the item's parent item.</p>
<p>This procedure returns the item's parent item, if any.</p>
<div class="refsect3">
<a name="gimp-item-get-parent.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-parent.returns"></a><h4>Returns</h4>
<p>The item's parent item. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-children"></a><h3>gimp_item_get_children ()</h3>
<pre class="programlisting"><a class="link" href="GimpItem.html" title="gimpitem"><span class="returnvalue">GimpItem</span></a> **
gimp_item_get_children (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                        <em class="parameter"><code><span class="type">gint</span> *num_children</code></em>);</pre>
<p>Returns the item's list of children.</p>
<p>This procedure returns the list of items which are children of the
specified item. The order is topmost to bottommost.</p>
<div class="refsect3">
<a name="gimp-item-get-children.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>num_children</p></td>
<td class="parameter_description"><p>The item's number of children. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-children.returns"></a><h4>Returns</h4>
<p>The item's list of children.
The returned value must be freed with <code class="function">g_free()</code>. </p>
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_children][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GimpItem][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-list-children"></a><h3>gimp_item_list_children ()</h3>
<pre class="programlisting"><span class="returnvalue">GList</span> *
gimp_item_list_children (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns the item's list of children.</p>
<p>This procedure returns the list of items which are children of the
specified item. The order is topmost to bottommost.</p>
<div class="refsect3">
<a name="gimp-item-list-children.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-list-children.returns"></a><h4>Returns</h4>
<p>The item's list of children.
The returned list must be freed with <code class="function">g_list_free()</code>. Item
elements belong to libgimp and must not be unrefed. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GimpItem][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-expanded"></a><h3>gimp_item_get_expanded ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_get_expanded (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Returns whether the item is expanded.</p>
<p>This procedure returns TRUE if the specified item is expanded.</p>
<div class="refsect3">
<a name="gimp-item-get-expanded.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-expanded.returns"></a><h4>Returns</h4>
<p> TRUE if the item is expanded, FALSE otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-set-expanded"></a><h3>gimp_item_set_expanded ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_set_expanded (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                        <em class="parameter"><code><span class="type">gboolean</span> expanded</code></em>);</pre>
<p>Sets the expanded state of the item.</p>
<p>This procedure expands or collapses the item.</p>
<div class="refsect3">
<a name="gimp-item-set-expanded.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>expanded</p></td>
<td class="parameter_description"><p>TRUE to expand the item, FALSE to collapse the item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-set-expanded.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-name"></a><h3>gimp_item_get_name ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> *
gimp_item_get_name (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Get the name of the specified item.</p>
<p>This procedure returns the specified item's name.</p>
<div class="refsect3">
<a name="gimp-item-get-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-name.returns"></a><h4>Returns</h4>
<p>The item name.
The returned value must be freed with <code class="function">g_free()</code>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-set-name"></a><h3>gimp_item_set_name ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_set_name (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                    <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
<p>Set the name of the specified item.</p>
<p>This procedure sets the specified item's name.</p>
<div class="refsect3">
<a name="gimp-item-set-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>The new item name.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-set-name.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-visible"></a><h3>gimp_item_get_visible ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_get_visible (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Get the visibility of the specified item.</p>
<p>This procedure returns the specified item's visibility.</p>
<div class="refsect3">
<a name="gimp-item-get-visible.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-visible.returns"></a><h4>Returns</h4>
<p> The item visibility.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-set-visible"></a><h3>gimp_item_set_visible ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_set_visible (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                       <em class="parameter"><code><span class="type">gboolean</span> visible</code></em>);</pre>
<p>Set the visibility of the specified item.</p>
<p>This procedure sets the specified item's visibility.</p>
<div class="refsect3">
<a name="gimp-item-set-visible.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>visible</p></td>
<td class="parameter_description"><p>The new item visibility.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-set-visible.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-linked"></a><h3>gimp_item_get_linked ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_get_linked (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Get the linked state of the specified item.</p>
<p>This procedure returns the specified item's linked state.</p>
<div class="refsect3">
<a name="gimp-item-get-linked.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-linked.returns"></a><h4>Returns</h4>
<p> The item linked state (for moves).</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-set-linked"></a><h3>gimp_item_set_linked ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_set_linked (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                      <em class="parameter"><code><span class="type">gboolean</span> linked</code></em>);</pre>
<p>Set the linked state of the specified item.</p>
<p>This procedure sets the specified item's linked state.</p>
<div class="refsect3">
<a name="gimp-item-set-linked.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>linked</p></td>
<td class="parameter_description"><p>The new item linked state.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-set-linked.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-lock-content"></a><h3>gimp_item_get_lock_content ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_get_lock_content (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Get the 'lock content' state of the specified item.</p>
<p>This procedure returns the specified item's lock content state.</p>
<div class="refsect3">
<a name="gimp-item-get-lock-content.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-lock-content.returns"></a><h4>Returns</h4>
<p> Whether the item's contents are locked.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-set-lock-content"></a><h3>gimp_item_set_lock_content ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_set_lock_content (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                            <em class="parameter"><code><span class="type">gboolean</span> lock_content</code></em>);</pre>
<p>Set the 'lock content' state of the specified item.</p>
<p>This procedure sets the specified item's lock content state.</p>
<div class="refsect3">
<a name="gimp-item-set-lock-content.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>lock_content</p></td>
<td class="parameter_description"><p>The new item 'lock content' state.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-set-lock-content.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-lock-position"></a><h3>gimp_item_get_lock_position ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_get_lock_position (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Get the 'lock position' state of the specified item.</p>
<p>This procedure returns the specified item's lock position state.</p>
<div class="refsect3">
<a name="gimp-item-get-lock-position.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-lock-position.returns"></a><h4>Returns</h4>
<p> Whether the item's position is locked.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-set-lock-position"></a><h3>gimp_item_set_lock_position ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_set_lock_position (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                             <em class="parameter"><code><span class="type">gboolean</span> lock_position</code></em>);</pre>
<p>Set the 'lock position' state of the specified item.</p>
<p>This procedure sets the specified item's lock position state.</p>
<div class="refsect3">
<a name="gimp-item-set-lock-position.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>lock_position</p></td>
<td class="parameter_description"><p>The new item 'lock position' state.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-set-lock-position.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-color-tag"></a><h3>gimp_item_get_color_tag ()</h3>
<pre class="programlisting"><a href="../html/libgimpbase3-gimpbaseenums.html#GimpColorTag"><span class="returnvalue">GimpColorTag</span></a>
gimp_item_get_color_tag (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Get the color tag of the specified item.</p>
<p>This procedure returns the specified item's color tag.</p>
<div class="refsect3">
<a name="gimp-item-get-color-tag.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-color-tag.returns"></a><h4>Returns</h4>
<p> The item's color tag.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-set-color-tag"></a><h3>gimp_item_set_color_tag ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_set_color_tag (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                         <em class="parameter"><code><a href="../html/libgimpbase3-gimpbaseenums.html#GimpColorTag"><span class="type">GimpColorTag</span></a> color_tag</code></em>);</pre>
<p>Set the color tag of the specified item.</p>
<p>This procedure sets the specified item's color tag.</p>
<div class="refsect3">
<a name="gimp-item-set-color-tag.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>color_tag</p></td>
<td class="parameter_description"><p>The new item color tag.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-set-color-tag.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-tattoo"></a><h3>gimp_item_get_tattoo ()</h3>
<pre class="programlisting"><span class="returnvalue">guint</span>
gimp_item_get_tattoo (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>);</pre>
<p>Get the tattoo of the specified item.</p>
<p>This procedure returns the specified item's tattoo. A tattoo is a
unique and permanent identifier attached to a item that can be used
to uniquely identify a item within an image even between sessions.</p>
<div class="refsect3">
<a name="gimp-item-get-tattoo.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-tattoo.returns"></a><h4>Returns</h4>
<p> The item tattoo.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-set-tattoo"></a><h3>gimp_item_set_tattoo ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_set_tattoo (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                      <em class="parameter"><code><span class="type">guint</span> tattoo</code></em>);</pre>
<p>Set the tattoo of the specified item.</p>
<p>This procedure sets the specified item's tattoo. A tattoo is a
unique and permanent identifier attached to a item that can be used
to uniquely identify a item within an image even between sessions.</p>
<div class="refsect3">
<a name="gimp-item-set-tattoo.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tattoo</p></td>
<td class="parameter_description"><p>The new item tattoo.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-set-tattoo.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-attach-parasite"></a><h3>gimp_item_attach_parasite ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_attach_parasite (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                           <em class="parameter"><code>const <a href="/local/head/share/gtk-doc/html/libgimpbase/libgimpbase-GimpParasite.html#GimpParasite"><span class="type">GimpParasite</span></a> *parasite</code></em>);</pre>
<p>Add a parasite to an item.</p>
<p>This procedure attaches a parasite to an item. It has no return
values.</p>
<div class="refsect3">
<a name="gimp-item-attach-parasite.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>parasite</p></td>
<td class="parameter_description"><p>The parasite to attach to the item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-attach-parasite.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-detach-parasite"></a><h3>gimp_item_detach_parasite ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_item_detach_parasite (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
<p>Removes a parasite from an item.</p>
<p>This procedure detaches a parasite from an item. It has no return
values.</p>
<div class="refsect3">
<a name="gimp-item-detach-parasite.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>The name of the parasite to detach from the item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-detach-parasite.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-parasite"></a><h3>gimp_item_get_parasite ()</h3>
<pre class="programlisting"><a href="/local/head/share/gtk-doc/html/libgimpbase/libgimpbase-GimpParasite.html#GimpParasite"><span class="returnvalue">GimpParasite</span></a> *
gimp_item_get_parasite (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                        <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
<p>Look up a parasite in an item</p>
<p>Finds and returns the parasite that is attached to an item.</p>
<div class="refsect3">
<a name="gimp-item-get-parasite.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>The name of the parasite to find.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-parasite.returns"></a><h4>Returns</h4>
<p>The found parasite. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-item-get-parasite-list"></a><h3>gimp_item_get_parasite_list ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> **
gimp_item_get_parasite_list (<em class="parameter"><code><a class="link" href="GimpItem.html" title="gimpitem"><span class="type">GimpItem</span></a> *item</code></em>,
                             <em class="parameter"><code><span class="type">gint</span> *num_parasites</code></em>);</pre>
<p>List all parasites.</p>
<p>Returns a list of all parasites currently attached the an item.</p>
<div class="refsect3">
<a name="gimp-item-get-parasite-list.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>item</p></td>
<td class="parameter_description"><p>The item.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>num_parasites</p></td>
<td class="parameter_description"><p>The number of attached parasites. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-item-get-parasite-list.returns"></a><h4>Returns</h4>
<p>The names of currently attached parasites.
The returned value must be freed with <code class="function">g_strfreev()</code>. </p>
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_parasites][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> gchar*][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.0</div>
</body>
</html>